AEPutAttributePtr

Use pointer to create Apple Event attribute

#include <AppleEvents.h> Apple Event Manager

OSErr AEPutAttributePtr( theAppleEvent, theAEkeyword, typecode,

dataPtr, dataSize );

AppleEvent * theAppleEvent ; Apple Event to add attribute to

AEKeyword theAEkeyword ; Apple Event keyword

DescType typeCode ; descriptor type of attribute

Ptr dataPtr ; pointer to buffer containing data

Size dataSize ; size of data to be assigned to attribute

returns Error Code; 0 = no error

The AEPutAttributePtr function takes a pointer to data, a

descriptor type, and a keyword and converts them into an attribute that it

adds to an Apple event.

The parameter theAppleEvent is the Apple event to which you are adding an

attribute.

The parameter theAEKeyword is the keyword of the attribute. If there was

already an attribute with this keyword in the Apple event, it is replaced.

The typeCode parameter is the descriptor type for the attribute.

The dataPtr parameter is a pointer to the buffer containing the data to be

assigned to the attribute.

The dataSize parameter is the length, in bytes, of the data to be assigned to the

attribute.

The keyword can be one of the following:

Attribute keyword Description

keyAddressAttr Address of target application

keyEventClassAttr Event class of Apple event

keyEventIDAttr Event ID of Apple event

keyEventSourceAttr Source of the Apple event

keyInteractLevelAttr Settings for allowing the Apple Event

Manager to bring a server application to

the foreground

keyMissedKeywordAttr First required parameter remaining

in an Apple event.

keyOptionalKeywordAttr List of optional Apple event parameters

keyReturnIDAttr Return ID for reply Apple event

keyTimeoutAttr Length of time in ticks that the client

will wait for a reply or a result from

the server

keyTransactionIDAttr Transaction ID identifying a series of

Apple events

Result codes

noErr (0) No error

memFullErr (-108) Not enough room in heap zone

errAECoercionFail  (-1700) Data could not be  coerced to descriptor type
 errAENotAEDesc (-1704) Not a valid descriptor  record

Referenced by (4):